[automation] Sync SecondBrain framework (2026-W28)#3
Merged
Conversation
There was a problem hiding this comment.
Pull request overview
Automated weekly sync that expands the reusable SecondBrain framework to include explicit Codex skills ($dtm, $voice), collaborative writing + internal documents workflows, and improved wiki tooling (system log relocation + open-questions queue generation).
Changes:
- Add
dtmandvoiceskills (explicit-only, thread-scoped DTM) and install/export them with the framework. - Introduce writing/documents workflow templates, linters, and automation definitions; update DTM/Wiki contracts accordingly.
- Update wiki tooling to use a root
log.mdand generatework/wiki-open-questions.mdfrom wiki open-question sections.
Reviewed changes
Copilot reviewed 45 out of 45 changed files in this pull request and generated 8 comments.
Show a summary per file
| File | Description |
|---|---|
| tests/test_framework.py | Adds regression tests ensuring skills are explicit-only and properly scoped. |
| README.md | Updates DTM description to include authored work products. |
| install.py | Installs framework/skills into the vault’s skills/ directory. |
| framework/tools/writing.py | New writing workflow linter/status CLI for writing/. |
| framework/tools/wiki.py | Moves log handling to root log.md and adds wiki open-questions queue generation. |
| framework/tools/publish_framework.py | Broadens PR branch matching for publication PR discovery. |
| framework/tools/dtm.py | Adds activity command to append a Notes & Activity entry idempotently. |
| framework/tools/documents.py | New documents workflow linter/status CLI for documents/. |
| framework/templates/writing-piece.md | New template for writing pieces with publish markers and metadata. |
| framework/templates/voice-pack.md | New template for a writing voice pack maintained by $voice. |
| framework/templates/project.md | Clarifies project Decisions section wording. |
| framework/templates/document-piece.md | New template for internal documents with required frontmatter. |
| framework/templates/daily-note.md | Updates Decisions guidance text to concise bullet decisions. |
| framework/skills/voice/SKILL.md | Adds $voice skill contract excluding drafts and limiting corpus scope. |
| framework/skills/voice/agents/openai.yaml | Adds explicit-only skill metadata for voice. |
| framework/skills/dtm/SKILL.md | Adds $dtm thread-scoped session contract and $end-dtm termination token. |
| framework/skills/dtm/agents/openai.yaml | Adds explicit-only skill metadata for DTM. |
| framework/publication-manifest.json | Exports skills + new tools/defaults; tightens forbidden live prefixes for privacy. |
| framework/DTM.md | Extends DTM operational contract (thread sessions, writing/docs workflows, decisions guidance, wiki-question queue). |
| framework/defaults/dtm/recurring-tasks.json | Adds new recurring tasks (wiki open question, weekly draft reviews). |
| framework/defaults/documents/README.md | Adds documents workspace README explaining lifecycle and conventions. |
| framework/automation-definitions/writing-publisher.json | Adds parameterized writing publisher automation definition. |
| framework/automation-definitions/weekly-diary-draft.json | Adds weekly diary draft automation definition. |
| framework/automation-definitions/dtm-daily-rollover.json | Tightens rollover prompt to match updated Decisions contract. |
| framework/AGENTS.md | Updates core agent contract: thread-scoped DTM sessions, writing/docs workspaces, log moved to log.md, opinion sources guidance, and publication constraints. |
| examples/empty-vault/writing/voice/voice-pack.md | Adds sanitized empty voice pack seed for the example vault. |
| examples/empty-vault/writing/ready/.gitkeep | Adds writing/ready scaffold. |
| examples/empty-vault/writing/README.md | Adds writing workspace README in the example vault. |
| examples/empty-vault/writing/published/.gitkeep | Adds writing/published scaffold. |
| examples/empty-vault/writing/log.md | Adds sanitized writing log scaffold. |
| examples/empty-vault/writing/index.md | Adds writing index scaffold. |
| examples/empty-vault/writing/drafts/.gitkeep | Adds writing/drafts scaffold. |
| examples/empty-vault/wiki/overview.md | Updates example wiki overview to reference root system log. |
| examples/empty-vault/wiki/log.md | Removed; log is now rooted at log.md. |
| examples/empty-vault/README.md | Clarifies that a minimal root log entry exists for lint. |
| examples/empty-vault/log.md | Adds root system log scaffold entry for example vault lint. |
| examples/empty-vault/documents/README.md | Adds documents workspace README scaffold in the example vault. |
| examples/empty-vault/documents/final/.gitkeep | Adds documents/final scaffold. |
| examples/empty-vault/documents/drafts/.gitkeep | Adds documents/drafts scaffold. |
| examples/empty-vault/documents/deliverables/README.md | Adds documents deliverables scaffold. |
| docs/publication.md | Clarifies interactive agents must not publish directly; only scheduled automation may. |
| docs/operations.md | Documents internal documents + collaborative writing workflows and $voice constraints. |
| docs/installation.md | Adds instructions for installing skills + documents lint validation step. |
| CONTRIBUTING.md | Adds writing lint to contributor validation commands. |
| .github/workflows/validate.yml | Ensures skills are installed and runs writing lint in CI. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
Automated allowlist-only synchronization of the reusable SecondBrain framework.
Privacy boundary
The exporter denied personal vault paths and scanned staged text for host paths, identifiers, and email addresses before publication.
Validation